package org.summerframework.core.base.service;


import org.summerframework.core.base.dto.BaseDTO;
import org.summerframework.core.exception.WebException;

import java.io.Serializable;
import java.util.List;

/**
 * 增删改查基层接口
 * <p>
 * 必须使用泛型, 不然转化对象会出问题
 * <p>
 *
 * @param <T> dto对象
 * @author 石超
 * @version 1.0.0
 */
public interface BaseService<T extends BaseDTO> extends Serializable {

    enum BASE_OP {
        //添删改
        INSERT, UPDATE, DELETE
    }

    /**
     * 保存对象
     *
     * @param record 需要保存对象,必须继承BaseDTO
     */
    T insert(T record);

    /**
     * 根据id删除
     *
     * @param id 查询id
     * @return 删除条数
     */
    Integer deleteById(Long id);

    /**
     * 根据id删除
     *
     * @param ids 查询id
     * @return 删除条数
     */
    default Integer deleteByIds(List<Long> ids) {
        if (ids == null) {
            return 0;
        }
        ids.forEach(this::deleteById);
        return ids.size();
    }

    /**
     * 根据id更新对象
     *
     * @param record 必须继承BaseDTO
     * @return 更新条数
     */
    Integer updateById(T record);

    /**
     * 根据id查询
     *
     * @param id 查询id
     * @return 查询的返回值
     */
    T selectById(Long id);

    /**
     * 根据id判断实体是否存在
     *
     * @param id 实体id
     * @return 是否存在
     */
    boolean isExistById(Long id);

    /**
     * 验证保存/更新
     *
     * @param baseOp  操作
     * @param baseDTO 验证的对象
     * @return 是否通过
     * @throws WebException 验证异常
     */
    boolean check(BASE_OP baseOp, T baseDTO) throws WebException;

    /**
     * 保存或更新
     *
     * @param record 存储对象
     * @return 保存/更新后的数据
     */
    T saveOrUpdate(T record);
}
